High-level URL Manager Functions

The URL Access Manager provides two high-level functions for downloading data from HTTP, HTTPS, FTP, and file:/// URLs:

URLSimpleDownload allows you to download data synchronously from a URL into a file, a directory, or into memory.
URLDownload allows you to download data synchronously from a URL reference into a file, a directory, or into memory. Using a URL reference to identify the URL allows you to obtain and set information about the URL, such its file type and creator, an associated user name and password, and the HTTP method, header, body, and user agent.

Both functions allow you to specify an application-defined system event callback routine that the URL Access Manager calls in order to convey system events to your application during the download process. You can control whether an existing file is replaced, whether a progress indicator is displayed during the transfer, and whether an authentication dialog is displayed if the URL requires authentication. You can also specify that encoded files are to be decoded and expanded if the Stuffit Engine is installed, indicate that the URL is a directory, or specify that you want to download a directory listing instead of the contents of a file or directory.

The URL Access Manager provides two high-level functions for uploading data to an FTP URL:

URLSimpleUpload allows you to upload data synchronously from a file or a directory.
URLUpload allows you to upload data synchronously from a file or directory to a URL reference. As with URLDownload , specifying a URL reference allows you to obtain and set information about the URL before you call URLUpload .

Both functions allow you to specify that the data is to be encoded in BinHex format, that a progress indicator is to be displayed, and that an authentication dialog box is to be displayed if the URL requires authentication.